---
layout: docs
page_title: 'nomad deployment list command reference'
description: |
  The `nomad deployment list` command lists deployments.
---

# `nomad deployment list` command reference

The `deployment list` command is used list all deployments.

## Usage

```plaintext
nomad deployment list [options]
```

The `deployment list` command requires no arguments.

When ACLs are enabled, this command requires a token with the 'read-job'
capability for the deployment's namespace.

## Options

- `-json` : Output the deployments in their JSON format.
- `-filter`: Specifies an expression used to filter query results.
- `-t` : Format and display the deployments using a Go template.
- `-verbose`: Show full information.

## Examples

List all tracked deployments:

```shell-session
$ nomad deployment list
ID        Job ID   Job Version  Status      Description
8990cfbc  example  2            failed      Deployment marked as failed
62eb607c  example  1            successful  Deployment completed successfully
5f271fe2  example  0            successful  Deployment completed successfully
```

## General options

@include 'general_options.mdx'
